home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48_2 / areuh.tar / areuh / README < prev   
Text File  |  1990-10-10  |  4KB  |  141 lines
  1. AUTHORS
  2. -------
  3.  
  4. Pierre DAVID (pda@masi.ibp.fr or pda@frunip62.bitnet)
  5. Janick TAILLANDIER
  6.  
  7. You are free to use or distribute these programs as long as
  8. you keep this note
  9.  
  10. These programs are provided as is.  They are in no way
  11. supported by us.
  12.  
  13.  
  14. PRESENTATION
  15. ------------
  16.  
  17. These programs provide you with a complete development
  18. system for the Saturn processor (used on the HP-71, HP-28,
  19. HP-48 among others).  It includes an assembler, a linker for
  20. separate assembly, and various utilities to generate message
  21. tables for the HP-71 as well as download programs to the
  22. HP-71 via HP-IL or RS-232.
  23.  
  24.  
  25. HISTORY
  26. -------
  27.  
  28. It was developped for the HP-71 in order for us to produce
  29. more easily the JPC Rom (PPC Paris Rom) for the HP-71.  The
  30. final Rom module was 45 KB (executable) for a total of 1.5
  31. MB source files.
  32.  
  33. The speed was one of the main design objectives.
  34.  
  35. These programs were written in C for the HP Integral PC
  36. (under HP-UX) in 1986 and have been adaptated for PC
  37. compatibles (Microsoft C 4.0 in 1987).
  38.  
  39. It was also used as the final stage of a simple C compiler
  40. for the HP-71.
  41.  
  42.  
  43. HP-71 DEPENDENCIES
  44. ------------------
  45.  
  46. This development system is fully compatible with the
  47. assembler described in the HP-71 Internal Design
  48. Specifications (Volumes I or IV).  The opcode syntax is the
  49. one used by HP :  it seems crazy to invent a new one, just
  50. to confuse everyone!
  51.  
  52. Some macros (LEX, BIN, FORTH, TOKEN...)  are specific to the
  53. HP-71, but you are free not to use them.
  54.  
  55. You may also want to write specific HP-48 macros to generate
  56. specific objects (it would be nice if HP give us the syntax
  57. they use).
  58.  
  59. Some opcodes used in newer machines (28, 48...)  are not
  60. present in the HP-71.  Those opcodes (but PC=(A) and RSI)
  61. are not in our opcode table, but could be easily added if
  62. they are known.
  63.  
  64. The linker preloads a special file (/usr/local/lib/hp71.ep)
  65. containing all HP-71 operating system entry points.  Do not
  66. use any name contained in this file, or remove the loading
  67. of this file.
  68.  
  69. In summary, HP-71 dependencies should not be a problem.
  70. However if you want to use new opcodes, you will have to add
  71. them.  Please, post your modifications.
  72.  
  73.  
  74. CONTENTS
  75. --------
  76.  
  77. Makefile
  78.     The global Makefile (HP-UX) to generate all programs.
  79.  
  80. assembler
  81.     Source code for aas (the assembler).  Some files are
  82.     shared between assembler, linker and dump (common.h,
  83.     err.h), some are shared between assembler and linker
  84.     (exp.c, mdep.c).
  85.     Contains a manual page in French.
  86.  
  87. linker
  88.     Source code for ald (the linker).
  89.     Contains a manual page in French.
  90.  
  91. dump
  92.     Source code for adp (the file dumper, used for
  93.     debugging).
  94.     Contains a manual page in French.
  95.  
  96. cpy
  97.     Source code for downloading files from a PC to an
  98.     HP-71 using HP-IL Link card or RS-232.  This should
  99.     now superseded for HP-48 by Kermit.
  100.  
  101. load
  102.     Source code for acp, utility for copying an
  103.     executable file generated by the linker to a LIF
  104.     disk (to be read by an HP-71 with HP-9114).
  105.  
  106. equ
  107.     Source for all HP-71 operating system entry points.
  108.  
  109. jmpdoc
  110.     Some thoughts about adding a new generic branch macro.
  111.     In French. Garbage.
  112.  
  113. msg
  114.     Source code for amg (HP-71 message table generator).
  115.     Contains a manual page in French.
  116.  
  117. doc
  118.     Various documentations.
  119.  
  120.  
  121. PORTING
  122. -------
  123.  
  124. If you are using HP-UX, just type make, then make install.
  125.  
  126. If you are using another flavor of Unix, the Makefile should
  127. work. We think there are no special system dependencies (it was
  128. successfully compiled on Suns 3 and 4 with SunOS 4 and a Vax
  129. under BSD 4.3).
  130.  
  131. If you are using PC compatibles, we cannot do anything for you.
  132. The Makefiles will probably be difficult to use...
  133.  
  134. If you are using an Amiga, a Mac or anything else, good work !
  135.  
  136.  
  137.  
  138. Have fun !
  139.  
  140. Pierre DAVID & Janick TAILLANDIER (July 1st, 1990)
  141.